Lấy danh sách tiền tệ

Trả về danh sách các cặp tiền tệ mà Baokim có thể báo giá cho Merchant yêu cầu. Chỉ các cặp có thể báo giá một cách tin cậy mới được trả về.

Chúng tôi khuyến nghị gọi API này tối đa một lần mỗi ngày — danh sách các tiền tệ được hỗ trợ rất hiếm khi thay đổi.

Đường dẫn

• URL: /cb-core/api/v1/fx/get-currencies
• Method: POST
• Mô tả: Lấy danh sách các cặp tiền tệ được hỗ trợ.

Request

Bảng Request

Tham số	Loại dữ liệu	Bắt buộc	Mô tả
request_id	string(50)	Có	Mã duy nhất định danh request. Định dạng gợi ý: MerchantCode + BK + YYYYMMDD + UniqueId
request_time	string(19)	Có	Thời gian Merchant gửi request. Định dạng: YYYY-MM-DD HH:MM:SS
merchant_code	string(20)	Có	Mã merchant được Baokim cung cấp trước khi tích hợp

Ví dụ Request

{
  "request_id": "MERCHANT1234BK202606051",
  "request_time": "2026-06-05 10:15:30",
  "merchant_code": "MERCHANT1234"
}

Response

Bảng Response

Tham số	Loại dữ liệu	Bắt buộc	Mô tả
response_code	int(4)	Có	Mã kết quả từ Baokim, theo bảng Mã lỗi
response_message	string(200)	Có	Mô tả mã kết quả
merchant_code	string(20)	Có	Mã merchant được Baokim cung cấp trước khi tích hợp
data	Array of Objects	Có	Danh sách các cặp tiền tệ được hỗ trợ

Cấu trúc mảng Data (bên trong data)

Tham số	Loại dữ liệu	Mô tả
currency_pair	string(10)	Cặp tiền tệ ở định dạng BASE/QUOTE (ví dụ USD/VND)
base_currency	string(10)	Mã ngoại tệ (ví dụ USD)
quote_currency	string(10)	Mã tiền tệ báo giá (ví dụ VND)
base_currency_name	string(50)	Tên hiển thị của ngoại tệ
quote_currency_name	string(50)	Tên hiển thị của tiền tệ báo giá

Ví dụ Response

{
  "response_code": 200,
  "response_message": "Thành công",
  "merchant_code": "MERCHANT1234",
  "data": [
    {
      "currency_pair": "USD/VND",
      "base_currency": "USD",
      "quote_currency": "VND",
      "base_currency_name": "Đô la Mỹ",
      "quote_currency_name": "Đồng Việt Nam"
    },
    {
      "currency_pair": "CNY/VND",
      "base_currency": "CNY",
      "quote_currency": "VND",
      "base_currency_name": "Nhân dân tệ Trung Quốc",
      "quote_currency_name": "Đồng Việt Nam"
    }
  ]
}

Mã lỗi

Mã Response	Thông báo Response
200	Thành công
101	Lỗi hệ thống
110	Mã merchant không hợp lệ
120	Signature không hợp lệ
422	Lỗi xác thực
429	Quá nhiều yêu cầu